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CHAPTER  1 


1.0  INTRODUCTION 

1.1  Manual  Contents  -  This  manual  contains  all  of  the 
information  needed  to  successfully  use  an  IF-11Q/X.25  in  an 
LSI-ll  based  computer  system  for  X.25  protocol  communication. 
Installation  considerations  and  procedures  are  detailed.  Host 
device  driver  programming  is  explained,  and  an  example  device 
driver  listing  is  included  as  an  appendix.  The  X.25  protocol 
data  and  control  programming  is  described  with  all  message 
formats  and  contents  presented  in  tabular  form.  Information 
explaining  the  power-up  microdiagnostics  completes  this  manual. 

1.2  IF-11Q/X.25  System  Overview  -  The  IF-11Q/X.25  is  a 
microprocessor  based  communications  front-end  developed  by 
Associated  Computer  Consultants  (ACC).  The  IF-11Q/X.25 
provides  DMA  support  for  LSI-li  applications  which  require  X.25 
capability.  The  protocol  conforms  to  ISO  HDLC  specifications 
for  a  combined  station  operating  in  Asynchronous  Balanced  Mode 
(ABM),  implementing  options  2  (reject),  and  8  (command  I-frames 
only).  X.25  frames  are  assembled  and  verified  independent  of 


host  activity 


1.3  Hardwar e  -  The  IF-11Q/X.25  hardware  consists  of  an  MDMA 
controller  and  an  XQ/CP  subsystem.  The  MDMA  is  a  microcoded 
bit-slice  DMA  controller  which  implements  a  Subsystem  Interface 
Bus  which  connects  the  XQ/CP  to  the  L3I-11  bus.  All  MDMA 
functions  are  packaged  on  a  single  LSI-11  dual  wide  circuit 
card.  The  XQ/CP  is  a  Zilog  Z-80  based  communication  subsystem 
which  has  been  used  to  implement  the  X.25  protocol  by  means  of 
ROM-based  software.  The  XQ/CP  consists  of  three  L3I-11  dual 
width  circuit  cards.  The  Interface  Board  (I-Board)  connects 
the  XQ/CP  to  the  MDMA.  The  Memory  Board  (M-Board)  contains  the 
RAM  and  ROMs  for  the  X.25  protocol.  The  Processor  Board 
(P-Board)  contains  the  Z-80  CPU  and  the  serial  I/O  connections. 

1.4  Software  -  The  application  program  can  send  and  receive 
"Data  Frames"  as  well  as  control  and  sense  the  status  of  the 
physical  link  by  means  of  "Supervisory  Command  Messages"  (See 
Chapter  5).  Separate  "logical  channels"  are  used  for  these  two 
different  kinds  of  information.  The  host  device  driver  and  the 
XQ/CP  I/O  Executive  (lOX) ,  together,  use  the  LSI-11  bus 
interface  hardware  to  implement  multiple  logical  channels  (See 
Chapter  4).  The  IF-llQ/X.25  firmware  thus  implements  two 
levels  of  software  protocols.  The  lower  level  being  a 
multiplexing  protocol  and  the  higher  level  being  the  X.25 
protocol.  (See  Figure  1-1.) 
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CHAPTER  2 


2.0  REFERENCES 


2.1  Reference  Documents  -  The  following  documents  will  assist 
the  user  in  understanding  the  operation  of  the  IF-llQ/HDLC: 


1 .  Data  Communications  Standards 
(International  Organization  for  Standards) 

2.  XQ/CP  Maintenance  Manual (XQCP. MM. VQQl) 

Associated  Computer  Consultants,  Santa  Barbara,  CA 
93101 

3.  Multichannel  DMA  Controller  for  LSI~11 (MDMA.MM. VQQ2 ) 
Associated  Computer  Consultants,  Santa  Barbara,  CA 
93101 

4 .  XQ/CP  Communications  Processor  Software  Support 
Monitor  Manual  (XQCP.SSMM. VOOl ) 

Associated  Computer  Consultants,  Santa  Barbara,  CA 
93101 
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CHAPTER  3 


3.0  HARDWARE  INSTALLATION 

3.1  Shipping  Checklist  -  The  IF-llQ/X.25  distribution  package 
consists  of  the  following  items: 

A.  One  MDMA  Board. 

B.  One  XQ/CP  I-Board. 

C.  One  XQ/CP  M-Board. 

D.  One  XQ/CP  P-Board. 

E.  One  Distribution  Panel  (RS-232C,  RS-449, 

or  MIL-STD-ia8-114) . 

F.  Three  (short)  flat  ribbon  cables 
to  connect  the  boards  together, 

G.  Two  (long)  ribbon  cables  to  connect 

the  XQ/CP  P-Board  to  the  distribution  panel. 

H.  One  IF-llQ/X.25  User's  Manual. 

3.2  Drawing  Reference  -  When  performing  hardware  installation, 
refer  to  the  following  drawings  which  are  included  in 
Appendix  A  of  this  manual: 

ACC  Drawing  No.  Title 

8600106  Top  Assembly,  IF-llQ/X.25 

8300222  Cable  Configuration,  Null  Modem 


3.3  Installation  Considerations  -  The  IF-11Q/X.25  is  installed 
in  an  LSI-11  processor  box  or  expansion  chassis  and  requires: 

A.  Four  contiguous  dual-height  LSI-IJ  bus  slots. 

B.  The  following  DC  currents  (Absolute  MAX): 


DC  Voltage 

MDMA 

I-board 

M-board 

P-board 

TOTAL 

+  5V 

3.0A 

2.72A 

3.26A 

2.26A 

11.24 

+12V 

O.OA 

O.OA 

0.96A 

0.27A 

1.23 

Switch  and 

J  umper 

Options  - 

All  switch 

and  jumper 

options 

have  been  pre-set  by  the  factory.  The  default  CSR  address  is 
0776200,  and  the  default  interrupt  vectors  are  0140  for  input 
and  0144  for  output.  Refer  to  the  maintenance  manuals  or 
contact  the  factory  for  other  configurations. 
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3.5 


Attachment  to  LSI-11  System  - 


When 


attaching 


the 


IF-llQ/X.25  to  the  LSI-11  System,  the  following  sequence  should 
be  followed: 


A.  Remove  power  from  the  entire  LSI-11  system  before 
performing  the  subsequent  steps. 

B.  Install  the  distribution  panel  at  the  back  of  the  LSI-11 
cabinet . 

C.  Select  4  contiguous  LSI-11  bus  slots.  All  of  the 
IF-llQ/X.25  boards  provide  LSI-11  bus  DMA  grant 
continuity  and  interrupt  grant  continuity.  Care  should 
be  exercised  to  assure  that  grant  continuities  exist 
between  the  IF-llQ/X.25  and  the  LSI-11  processor  module 
due  to  other  boards  and  perhaps  unoccupied  LSI-11  Bus 
slots. 

D.  The  4-board  IF-llQ/X.25  system  comes  already  cabled 
together.  DO  NOT  DISCONNECT  THE  BOARDS  FROM  EACH  OTHER. 

E.  Position  the  connected  boards  over  the  LSI-11  Bus  slots 
and  insert  each  board  into  its  bus  slot. 

F.  Install  the  Serial  I/O  cables  between  the  distribution 
panel  and  the  XQ/CP  P-board  as  per  the  top  level  assembly 
drawing  in  Appendix  A,  Special  attention  should  be  given 
to  Pin  1  positioning  as  well  as  Port  A/Port  B  cable 
or  ientation. 

G.  Power  up  the  system  and  check  all  voltages. 

H.  Close  the  processor/expansion  box. 

I.  Start  up  system. 
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3.6  Serial  Interface  Pinout  -  ACC  drawing  #8300222  (Appendix 
A)  shows  the  pin  layout  for  a  null  modem  cable  used  to  link 
together  two  IF-11Q/X.25  systems.  Note  that  each  rF-llQ/X.25 
transmits  a  9600  bps  clock  signal  on  pin  24,  which  can  be  used 
if  an  external  clock  is  not  provided.  Also  note  that  the 
IF-11Q/X.25  does  not  respond  to  input  on  pins  8  and  22  (data 
carrier  detect  and  ring) . 
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CHAPTER  4 


4.0  HOST  DEVICE  DRIVER  PROGRAMMING 


4.1  Communication  Registers  -  The  IF-11Q/X.25  and  the  Host 
Device  Driver  interact  via  a  set  of  Hardware  Communication 
Registers  (see  Tables  4-1  and  4-2).  Eight  registers  are 
available  to  the  Host  Device  Driver: 


Receive  Control  and  Status  Register  (RCSR) 

Receive  Data  Register  (RDR) 

Receive  Address  Register  (RAR) 

Receive  Word  Count  Register  (RWCR) 

Transmit  Control  and  Status  Register  (TCSR) 

Transmit  Data  Register  (TDR) 

Transmit  Address  Register  (TAR) 

Transmit  Word  Count  Register  (TWCR) 


The  registers  of  the  Hardware  Communication  Register  occupy  a 
contiguous  block  of  addresses  on  the  LSI-11  BUS,  starting  at  an 
address  determined  by  switch  settings  on  the  MDMA  circuit 
board.  The  register  descriptions  in  Tables  4-1  and  4-2  are 
written  from  the  point  of  view  of  the  Host  Device  Driver.  For 
example,  the  sense  of  read  and  write  of  the  IF-11Q/X.25  RCSR 
and  TCSR  is  from  the  LSI-11.  A  sample  Device  Driver  listing  is 
included  in  this  manual  as  Appendix  B. 
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4.2  Hardware  Data  Transfer  -  A  DMA  transfer  is  started  when 
the  device  driver  loads  the  data  buffer  starting  address  into 
the  xAR  (i.e.,  RAR  or  WAR),  loads  the  2's  complement  of  the 
desired  transfer  word  count  into  the  xWCR,  and  sets  the  GO  bit 
in  the  xCSR.  If  a  matching  request  has  been  issued  by  the 
IF-11Q/X.25  software,  the  DMA  hardware  is  activated  and  the 
transfer  takes  place. 
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Table  4-1  IF-11Q/X.25  RCSR  (Receive  Control  and  Status  Register) 


+ - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + 


1  15 

1  141 

131  121 

111 

10 

1  9 

1  a 

17  16 

1  5  1 

4  1 

3  1  2 

1  1  1 

1 - 1- 

0  1 

1 

lERR 

1  1 
INXMI 

1  1 
ZS3 1ZS2 1 

1 

ZSl  1 

ZSO 

1 

1  zao 

1 

IDBF 

1  1 

1 RDY 1 lEN 

1  1 
lADR  1 

1 

ADRl 

1 

IREC 

1  1 
iREC  1 

1 

GO  1 

1 

1  1 

1  1 

1 

IHALT 

1 

1  1 

1  171 

16  1 

ISIG 

IRES  1 

1 

+ - 

+ - + 

- + - + 

- + 

— 

+ - 

+ - 

+ - + - 

+ - + 

- + 

- + - 

+ - +- 

- + 

R 

R/W 

R  R 

R 

R 

R 

R 

R/W  R/W 

R/W 

R/W 

R/W  R 

W 

w 

BIT  0  GO  The  GO  bit.  Setting  this  bit  clears  RDY 

and  initiates  a  DMA  transfer  from  the 
IF-11Q/X.25  to  the  LSI-11  processor. 
Clearing  this  bit  has  no  effect.  GO 
will  always  read  as  zero. 


BIT  1  REC  RESET 


BIT  2  REC  SIGNAL 


BIT  3  UNUSED 


BIT  4  ADR16 


BIT  5  ADR17 


The  RECEIVE  RESET  bit.  Setting  this  bit 
resets  the  receive  DMA  hardware.  The 
entire  IF-11Q/X.25  to  LSI-11  channel  is 
reset.  Clearing  this  bit  has  no  effect. 
This  bit  will  always  read  as  zero. 

The  RECEIVE  SIGNAL  bit.  This  bit  is  set 
to  one  upon  completion  of  a  receive  DMA 
data  transfer.  If  EIN  is  presently  set, 
the  LSI-11  is  interrupted.  RECEIVE 
SIGNAL  is  cleared  upon  reading  the  RCSR 
by  the  LSI-11.  This  bit  is  read-only, 
and  writing  to  this  bit  has  no  effect. 

This  bit  is  undefined  and  is  reserved 
for  future  use.  It  is  cleared  upon 
system  startup  or  reset. 

This  is  ADDRESS  BIT  16  for  extended 
addressing  operation.  This  bit  is  never 
modified  by  the  IF-11Q/X.25.  It  is 
cleared  upon  system  startup  or  reset. 

This  is  ADDRESS  BIT  17  for  extended 
addressing  operation.  This  bit  is  never 
modified  by  the  IF-11Q/X.25.  It  is 
cleared  upon  system  startup  or  reset. 
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Table  4-1,  continued 


BIT  6  lEN 


BIT  7  RDY 


BIT  8  DBF 


The  INTERRUPT  ENABLE  bit.  The  LSI-11 
program  sets  this  bit  to  allow  the 
channel  to  request  program  interrupts 
and  clears  it  to  disallow  interrupts. 
This  channel  only  responds  to  interrupt 
polling  cycles  when  this  bit  is  on.  It 
is  cleared  upon  system  startup  or  reset. 

The  READY  bit.  This  bit  is  on  when  the 
channel  is  not  in  DMA  mode.  When  the 
channel  is  ready,  the  Memory  Address 
Register,  the  Word  Count  Register,  and 
the  Control  and  Status  Register  may  be 
modified.  This  bit  goes  off  when  DMA 
mode  is  started  by  setting  the  GO  bit. 
When  DMA  mode  is  active,  setting  this 
bit  causes  DMA  to  be  stopped.  Clearing 
this  bit  has  no  effect.  This  bit  is  set 
upon  system  startup  or  reset. 

The  DATA  BUFFER  FLAG  bit.  This  bit 
indicates  that  the  Receive  Data  Buffer 
contains  a  word  and  is  ready  to  be  on 
read.  This  bit  is  allowed  to  be  on  only 
when  the  channel  is  in  DMA  mode 
(RDY  =  0),  DATA  BUFFER  FLAG  is  cleared 
when  the  Receive  Data  Buffet  is  read. 


BIT  9  Z80  HALT  The  Z80-CPU  HALT  bit.  This  bit 

indicates  the  halt  state  of  the 
IF-11Q/X.25  microprocessor.  If  the 
IF-11Q/X.25  is  halted,  this  bit  will 
read  as  one.  Otherwise,  this  bit  will 
read  as  zero.  This  is  a  read-only  bit 
and  writing  to  this  bit  has  no  effect. 

BIT  10  ZSO  This  is  Z80  STATUS  BIT  0.  This  bit  and 

the  following  Z80  status  bits  are  user 
defined  status  bits  passed  from  the 
IF-11Q/X.25  to  the  LSI-11.  These  bits 
are  read-only  and  writing  to  these  bits 
has  no  effect. 


BIT 

11 

ZSl 

This 

is 

ZSO 

STATUS 

BIT 

1. 

See 

ZSO. 

BIT 

12 

ZS2 

This 

is 

ZSO 

STATUS 

BIT 

2. 

See 

ZSO. 

BIT. 

13 

ZS3 

This 

is 

ZSO 

STATUS 

BIT 

3. 

See 

ZSO. 
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Table  4-1,  continued 


BIT  14  NXM 


BIT  15  ERR 


The  NONEXISTENT  MEMORY  ERROR  bit.  This 
bit  being  set  indicates  that  DMA  was 
attempted  to  an  LSI-11  address  which  did 
not  respond.  This  bit  is  set  by  the 


MDMA  and  is 
LSI-11. 

tested 

and 

reset 

by 

the 

The  COMPOSITE 

ERROR 

bit . 

This 

bit 

is 

the  logical  OR  of  all  error  bits. 
Currently  the  only  defined  error  is 
NONEXISTENT  MEMORY  ERROR.  The  ERROR  bit 
is  reset  by  resetting  all  other  error 
bits.  This  bit  is  read-only.  It  is 
cleared  upon  system  startup  or  reset. 
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Table  4-2  IF-11Q/X.25  TCSR  (Transmit  Control  and  Status  Register) 


+ + + + - + + + + - + - + + + - + + + + - + 

1  151  141  131  121  111  101  9  18  17  16  |  5  14  |  3  12  II  I  0  I 


IERRINXMIPS3 IPS2 IPSI IPSO  I  I  DBF  I RDY I lEN I  ADR  I  ADR | Z80 | XMT I XMT I  GO  I 

1  1  1  1  1  I  I  1  I  1  I  171  161RES1SIGIRES1  1 

+ - + - + - + - + - + - + - + + + + + + + + + - + 

R  R/W  R/W  R/W  R/W  R/W  R  R  R/W  R/W  R/W  R/W  R/W  R  W  W 


BIT  0  GO  The  GO  bit.  Setting  this  bit  causes 

RDY  to  be  reset  to  zero  and  initiates  a 
DMA  transfer  from  the  LSI-11  processor 
to  the  IF-11Q/X.25.  Clearing  this  bit 
has  no  effect.  GO  will  always  read  as 
zero. 

BIT  1  TRANS  RESET  The  TRANSMIT  RESET  bit.  Setting  this 

bit  resets  the  transmit  DMA  hardware. 
The  entire  LSI-11  to  IF-11Q/X.25  channel 
is  reset.  Clearing  this  bit  has  no 
effect.  This  bit  will  always  read  as 
zero. 

BIT  2  TRANS  SIGNAL  The  TRANSMIT  SIGNAL  bit.  This  bit  will 

always  read  as  zero.  Clearing  this  bit 
has  no  effect.  NOTE:  The  host  software 
must  never  set  this  bit. 

BIT  3  Z80  RESET  The  Z80  RESET  bit.  Setting  this  bit 

resets  the  Z80  hardware  in  the 
IF-llQ/X.25  and  causes  the  Z80  CPU  to 
restart  at  location  zero.  Clearing  this 
bit  has  no  effect.  This  bit  will  always 
read  as  zero. 

BIT  4  ADR16  This  is  ADDRESS  BIT  16  for  extended 

addressing  operation.  It  is  cleared 
upon  system  startup  or  reset. 

BIT  5  ADR17  This  is  ADDRESS  BIT  17  for  extended 

addressing  operation.  It  is  cleared 
upon  system  startup  or  reset. 
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Table  4-2,  continued 


BIT  6  lEN  The  INTERRUPT  ENABLE  bit.  The  LSI-11 

program  sets  this  bit  to  allow  the 
channel  to  request  program  interrupts 
and  clears  it  to  disallow  interrupts. 
This  channel  only  responds  to  interrupt 
polling  cycles  when  this  bit  is  on.  It 
is  cleared  upon  system  startup  or  reset. 

BIT  7  RDY  The  READY  bit.  This  bit  has  a  value  of 

one  when  the  channel  is  not  in  DMA  mode. 
When  the  channel  is  ready,  the  Memory 
Address  Register,  the  Word  Count 
Register,  and  the  Control  and  Status 
Register  may  be  modified.  This  bit  is 
cleared  when  DMA  mode  is  started  by 
setting  the  GO  bit.  When  DMA  mode  is 
active,  setting  RDY  causes  DMA  to  be 
stopped.  Clearing  this  bit  has  no 
effect.  This  bit  is  set  upon  system 
startup  or  reset. 

BIT  8  DBF  The  DATA  BUFFER  FLAG  bit.  This  bit 

indicates  that  the  Transmit  Data  Buffer 
is  empty  and  is  ready  to  accept  a  new 
word.  This  bit  has  a  value  of  one  only 
when  the  channel  is  in  DMA  mode 
RRDY  =  0).  DATA  BUFFER  FLAG  is  cleared 
when  the  Transmit  Data  Buffer  is 
written. 

BIT  9  UNUSED  This  bit  is  always  read  as  a  zero. 

BIT  10  PSO  This  is  PROCESSOR  STATUS  BIT  0.  This 

and  the  following  processor  status  bits 
are  user  defined  status  bits  passed  from 
the  LSI-11  program  to  the  IF-11Q/X.25 
program.  These  bits  may  be  set  or 
cleared  as  required  by  the  LSI-11 
program.  It  is  cleared  upon  system 
startup  or  reset. 

BIT  11  PSl  This  is  PROCESSOR  STATUS  BIT  1.  See 

PSO. 

BIT  12  PS2  This  is  PROCESSOR  STATUS  BIT  2.  See 

PSO. 

BIT  13  PS3  This  is  PROCESSOR  STATUS  BIT  3.  See 

PSO. 


Table  4-2,  continued 


BIT  14  NXM  The  NONEXISTENT  MEMORY  ERROR  bit.  This 

bit  has  a  value  of  one  DMA  was  attempted 
to  an  LSI-11  address  which  did  not 
respond.  This  bit  is  set  by  the  MDMA 
and  is  tested  and  reset  by  the  LSI-11 
program. 

BIT  15  ERR  The  COMPOSITE  ERROR  bit.  This  bit  is 

the  logical  OR  of  all  error  bits. 
Currently  the  only  defined  error  is 
NONEXISTENT  MEMORY  ERROR.  The  ERROR  bit 
is  reset  by  resetting  all  other  error 
bits.  This  bit  is  read-only.  It  is 
cleared  upon  system  startup  or  reset. 
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4.3  Software  Data  Transfer  -  The  IF-11Q/X.25  interface  to  the 
LSI-11  looks  like  two  DMA  'pipes'  -  one  to  carry  data  into  the 
IF-llQ/X.25  and  one  to  carry  data  away  from  it.  One  of  the 
tasks  of  the  IF-llQ/X.25  and  the  host  device  driver  in  the 
LSI-11  is  to  make  each  physical  data  pipe  look  like  several 
virtual  half  duplex  paths  to  higher  level  programs.  This  is 
done  by  enforcing  a  multiplexing  protocol  through  a  series  of 
supervisory  messages  associated  with  each  transfer  of  user 
data.  Thus,  two  types  of  information  being  passed  through  the 
pipes  are  distinguished:  the  four  byte  supervisory  messages 
(which  are  created  and  read  only  at  the  executive  driver 
level),  and  packets  of  user  data.  This  'user  data'  will  be 
called  'data'  while  the  virtual  half-duplex  data  path  will  be 
referred  to  as  a  'channel'  in  this  chapter.  See  Figures  4-1 
and  4-2. 
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REQUEST  ABORT 

READ  TO  SEND  LOCAL  ABORT  REMOTE  ABORT  ACKNOWLEDGE  lO  COMPLETE 

from  user  from  ramol*  liom  usar  Ifom  ramola  from  femola  Iron)  hardware 


Figure  4-1  IF-11Q/X.25  Multiplexing  Protocol  Input 

Finite  State  Automation 
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.-NEXT  STATE 
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•NEXT  STATE 


4.3.1  Requirements  Supported  by  the  Protocol  -  The  protocol 
insures  that  no  data  is  transferred  on  a  channel  until 
symmetric  requests  are  outstanding  in  the  LSI-11  and  the 
IF-11Q/X.25.  It  allows  simultaneous  requests  on  multiple 
channels,  but  only  one  request  to  be  outstanding  on  an 
individual  channel  at  a  time.  The  supervisory  messages  encode 
End-of-S tream  and  User  Subfunction  information  independent  of 
the  data  streams. 


4.3.2  Description  of  Message  Use  -  Each  message  type  and  its 
use  is  described  below.  The  messages  and  responses  are  all 
channel  specific. 


4. 3. 2,1  Request- to-Send  Message  -  Whenever  a  write  is 
activated,  a  Request- to-Send  NW  bytes  is  sent,  where  NW  =  the 
requested  byte  count.  The  four  bit  User  Subfunction  associated 
with  the  write  request  is  put  in  the  high  order  four  bits  of 
the  message  byte. 


NOTE 


A  write  is  'activated'  when  a  Write 
or  Write  End-of-Stream  request  is 
made  by  an  applications  program,  or 
whenever  a  data  transfer  completes 
which  partially,  but  not  completely, 
fulfills  the  original  request.  In 
the  latter  case,  NW  is  updated  to  be 
the  number  of  bytes  from  the  original 
request  which  have  not  yet  been 
written. 
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4. 3. 2. 2  OK-to-Send  Message  -  Whenever  a  read  is  outstanding 
for  NR  bytes  (NR  =  the  number  of  bytes  to  be  read)  and  a 
Request- to-Send  NW  bytes  message  is  received,  an  OK-to-Send  NB 
bytes  message  is  sent  (NB  =  minimum  {NR,NW}).  The  reading  side 
always  calculates  NB, 


NOTE 


A  read  is  'outstanding'  when  a  read 
request  is  made  by  an  applications 
program,  or  if  a  data  transfer  has 
completed  which  partially,  but  not 
completely,  fulfills  the  original 
request  and  the  preceeding  Data 
Follows  message  was  NOT 
End-of-Streara.  In  the  latter  case, 
NR  is  updated  to  reflect  the  number 
of  bytes  of  the  original  request 
which  have  not  yet  been  read. 


4. 3. 2. 3  Data  Follows  and  Data  Follows  End-of-Stream  Messages  - 
Whenever  an  OK-to-Send  NB  bytes  message  has  been  received,  a 
Data  Follows  or  Data  Follows  End-of-Stream  message  is  sent, 
followed  immediately  by  NB  bytes  of  data.  NO  MESSAGE  TRAFFIC 
OR  DATA  FROM  ANOTHER  CHANNEL  MAY  COME  BETWEEN  THE  MESSAGE  AND 
THE  DATA,  The  Data  Follows  End-of-Stream  message  is  sent  if, 
and  only  if,  the  original  Write  request  was  End-of-Stream  and 
NB  =  NW  (i.e.,  this  will  be  the  last  physical  transfer  to 
fulfill  an  End-of-Stream  Write  request) . 

4. 3. 2. 4  IQ  Abort  Message  -  An  10  Abort  message  is  sent  under 
the  following  conditions; 


1.  an  applications  program  closes  a  channel, 

2.  an  applications  program  issues  an  Abort  request, 

3.  a  protocol  breakdown  is  identified  with  respect  to  a 
channel . 


The  only  exception  is  when  an  10  Abort  message  has  previously 
been  sent  and  no  Abort  Acknowledge  message  has  been  received. 


4. 3. 2. 5  Abort  Acknowledge  Message  -  Whenever  an  10  Abort 
message  is  received,  an  Abort  Acknowledge  message  is  returned. 


4.3.3  Supervisory  Message  Format 


Byte  0  :  (Bits  0-2)  -  message  code 
;  (Bit  3)  -  must  be  zero 

:  (Bits  4-7)  -  user  subfunction 

Byte  1  :  virtual  channel  number 

Byte  2  ;  requested  byte  count  (low  byte) 

Byte  3  :  requested  byte  count  (high  byte) 


4.3.4  Message  Codes  - 


0  =  OK-to-Send 

1  =  Request- to-Send 

2  =  Data  Follows 

3  =  Data  Follows  End-of-S tream 

4  =  10  Abort 

5  =  Abort  Acknowledge 
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IF-llQ/X.25 
USER'S  MANUAL 


CHAPTER  5  -  X.25  PROTOCOL  PROGRAMMING 


CHAPTER  5 


5. a  X.25  PROTOCOL  PROGRAMMING 


5.1  Implementation  Notes  -  Several  design  decisions  were  made 
in  the  implementation  of  the  IF-11Q/X.25  which  must  be  taken 
into  account  in  application  programming  and  network  usage. 


5.1.1  Frame  Level  Window  Size  -  The  X.25  frame  level  window 
has  the  value  of  seven  and  cannot  be  changed  by  the  application 
program. 


5.1.2  Packet  Level  Window  Size  -  The  X.25  packet  level  window 
has  the  value  of  two  and  cannot  be  changed  by  the  application 
program. 


5.1.3  Loop-Back  Mode  -  The  IF-llQ/X.25  Loop-Back  switch  can 
be  set  to  any  value  by  the  application  program  and  initially 
has  a  value  of  zero.  A  value  of  zero  disables  X.25  loop-back 
mode  while  a  non-zero  value  enables  X.25  loop-back  mode.  (See 
"Restart  with  diagnostic  parameters",  Table  5-5) 


5.1.4  Tl  Timer  -  The  X.25  T1  timer  can  be  set  to  any  value  by 
the  application  program  and  initially  has  the  value  of  three 
seconds.  Legal  values  range  from  0  to  bi  seconds,  with  a 
resolution  of  one  second.  Please  note  that  a  value  of  zero 
specifies  no  timer  activity  and,  thus,  no  timer  recovery  will 
occur.  (See  "Restart  with  diagnostic  parameters".  Table  5-5) 


5.1.5  N2  Counter  -  The  X.25  N2  counter  can  be  set  to  any  value 
by  the  application  program  and  initially  has  the  value  of 
twenty.  Legal  values  range  from  2  to  255.  The  current  value 
remains  unchanged  if  an  illegal  value  is  specified.  (See 
"Restart  with  diagnostic  parameters".  Table  5-5) 


5.1.6  Packet  Size  -  The  X.25  data  packet  size  has  a  maximum 
value  of  one  hundred  twenty-eight  bytes  and  cannot  be  changed 
by  the  application  program. 
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5.2  Message  Formats  -  The  format  of  messages  between  the 
application  program  and  the  IF-ilQ/X.25  is  not  the  format  of 
messages  specified  by  CCITT  for  X.25  networks.  The  IF-iiQ/X.25 


system  converts  application  program  X.25  protocol 

requests 

into 

the 

format 

specified  by 

CCITT.  In  addition, 

any 

message 

over 

128 

bytes 

in  length 

will  automatically 

be 

conver  ted 

into 

multiple  M-Bit  packets  of  128  bytes. 


5.2.1  Supervisory  Message  Formats  -  All  supervisory  messages 
consist  of  a  fixed-length  header  optionally  followed  by  a 
variable-length  data  field.  The  header  is  four  bytes  in 
length.  The  optional  data  field  may  range  from  0  to  128  bytes 
in  length.  Supervisory  messages  are  always  sent  and  received 
via  logical  channel  zero. 


5. 2. 1.1  Fixed  Length  Messages  -  Many  supervisory  messages  do 
not  require  additional  data  beyond  the  header.  For  these 
messages  the  fourth  header  byte  contains  zero. 


5. 2. 1.2  Variable  Length  Messages  -  Some  supervisory  messages 
require  additional  data  beyond  the  header.  For  these  messages 
the  fourth  header  byte  contains  the  count  of  the  data  bytes 
which  immediately  follow  the  header. 


5.2.2  Data  Message  Formats  -  User  data  messages  may  range  from 
0  to  o55J5  bytes  in  length.  Data  messages  are  always  sent  and 
received  via  the  logical  channel  number  assigned  when  the  call 
is  established.  Logical  records  longer  than  b5535  bytes  are 
sent  as  multiple  messages  using  Write  Stream  for  all  but  the 
last  message  and  Write  Stream  and  End  for  the  last  message  (see 
Sections  o.o.4.1.i  and  6. 6, 4. 1.2). 


5. 2. 2.1  M-Bit  Packets  -  Any  message  over  128  bytes  in  length 
will  automatically  be  converted  into  multiple  M-Bit  packets  of 
128  bytes.  Only  the  last  packet  will  reflect  the  M-Bit  value 
specified  by  the  application  program,  while  the  others  will 
have  the  M-Bit  set. 
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5. 2. 2. 2  Q-3it  Data  -  User  data  is  normally  sent  as  non-Q-Bit 
data.  The  user  can  also  optionally  cause  packets  to  be  sent 
with  the  Q-Bit  set  to  one.  0-Bit  data  is  usually  used  at 
higher  protocol  levels  to  denote  control  data. 


5.3  Message  Contents  -  The  contents  of  messages  between  the 
application  program  and  the  IF-llQ/X.25  are  not  the  contents 
specified  by  CCITT  recommendation  X.25.  The  IF-llQ/X.25  system 
converts  application  program  X.25  protocol  request  contents 
into  those  specified  by  CCITT.  Table  3.1  details  the 
correlation  between  ACC  IF-llQ/X.25  commands  and  CCITT 
supervisory  packet  types. 


5.3.1  Supervisory  Message  Contents  -  All  supervisory  messsages 
have  a  four  byte  header.  The  first  byte  holds  the  command  code 
from  Table  5-2a.  The  second  byte  contains  the  full-duplex 
logical  channel  number  (LCN)  TIMES  TWO.  The  third  byte  is  used 
by  different  commands  for  different  purposes.  For  several 
message  types  the  third  byte  contains  the  virtual  circuit 
number.  The  fourth  byte  contains  the  count  of  optional  data 
bytes  which  follow  the  header  and  may  be  zero. 

5. 3. 1.1  Network  Commands  -  Table  5-1  describes  those  commands 
which  map  directly  into  CCITT  equivalents  and  initiate  or 
result  from  actual  network  activity. 
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Tne  IF- 


11/X.25  maintains  internal  information  pertaining  to  X.25 
network  operation.  Response  messages  which  return  partial 
contents  of  this  internal  information  may  be  elicited  by  means 
of  query  commands  from  Table  5-2b.  Table  5-3  details  the 
contents  of  the  different  responses.  Virtual  circuit  or 
logical  channel  information  can  be  obtained  by  means  of  two 
related  commands.  One  (Virtual  Circuit  Query)  takes  the 
virtual  circuit  number  as  an  index  while  the  other  (Logical 
Cnannel  Query)  takes  the  logical  channel  number  as  an  index. 
Both  commands  return  the  same  information.  Frame  level 
information  can  be  obtained  via  the  Frame  Level  Query  command. 
IF-llQ/X.25  network  errors  and  internal  error  conditions  can  be 
obtained  by  means  of  the  Error  Query  command.  Table  5-4 
contains  the  error  codes  returned  by  the  error  query. 

5.4.1  Data  Message  Contents  -  User  data  messages  are 
transmitted  and  received  in  complete  transparency.  No  headers 
are  required. 

5. 4. 1.1  Q-3it  Value  Specification  -  The  value  of  the  X.25  Q- 
Bit  for  a  message  is  typically  controlled  by  a  device  driver 
subfunction  value.  See  section  5.4. 


5.4. 1.2  M-Sit  Stream  Generation  -  The  generation  of  M-Bit 
Packet  streams  is  typically  controlled  oy  device  driver 
subfunction  values. 


5-4 


TABLE  5-i 


Correlation  between  ACC  IF-liQ/X.25  and  CCITT  Packet  Typos 


ACC  X.25  Co.Timands 

Answer 

Call 

Clear  Logical  Channel  and 
Clear  Virtual  Circuit 

Interrupt 

Interrupt  Acknowledge 
Ready 

Reset 

Reset  Acknowledge 
Restart 

Restart  Acknowledge 
Ring 


CCITT  Packet  Types 

Call  Accepted/Call  Connected 

Call  Request 

Clear  Confirmation  or 

Clear  Request/Clear  Indication 

Interrupt  Request 

Interrupt  Confirmation 

Receiver  Ready  or 
Receiver  Not  Ready 

Reset  Indication/Rcset  Request 

Reset  Confirmation 

Restart  Indication/Restart  Request 

Restart  Confirmation 

Incoming  Call 


0-0 


TABLE  5-2a 


ACC  IF-iiQ/X.25  Command  Codes 
(Ali  values  are  octal) 


Code 

Command 

Ou  j 

Answer 

OuO 

Call 

004 

Clear  Logical  Channel 

to  X.2o  Network 

002 

Clear  Virtual  Circuit 

from  X.25  Network 

042 

Interrupt 

045 

Interrupt  Acknowledge 

(Response  Only) 

043 

Ready 

0  40 

Reset 

u41 

Reset  Acknowledge 

lOo 

Restar  t 

lUi 

Restart  Acknowledge 

001 

Ring  from  X.25  Network 

TABLE  5-2b 


ACC  IF~11Q/X.25  Diagnostic  Query/Response  Code 
(Ail  values  are  octal) 


Code  Command/Response 


2u  / 
20  0 
213 
212 
203 
202 
201 
2u0 


Error 
Error 
Frame 
Frame 
Log  ic 
Log  ic 
Virtu 
Virtu 


Query  to  IF-11Q/X.25 
Response  from  IF-liQ/X.25 
Query  to  IF-ilQ/X.25 
Response  from  IF-11Q/X.25 
al  Cnannel  Query  to  IF-llQ/X. 
al  Cnannel  Response  from  IF-i 
al  Circuit  Query  to  IF-llQ/X. 
al  Circuit  Response  from  IF-1 


25 

IQ/X 

25 

IQ/X 


.25 

.25 


TABLE  5-3 


ACC  IF-11Q/X.25  Response  Message  Contents 
(Ail  values  are  octal) 


VIRTUAL  CIRCUIT  TABLE  RESPOiviSE: 


Offset  Contents 


U : 

1  ; 

2: 

3: 

4  : 

5 ; 

6 ; 

7: 

10: 

11  : 

12: 

13: 

14: 

15; 

lb-17; 

2u-21; 

22: 

23: 

24; 

25: 

26: 

2?-30; 
31-32; 
35-34  ; 
3 5-3  fa: 


response  type  {2u0) 
virtual  circuit  number 
zero 

response  length  (32) 

if  non-zero,  logical  channel  is  active 

logical  channel  number 

p(s)  for  receive  side 

p(r)  for  receive  side 

receive  window 

receive  flags 

p(s)  for  transmit  side 

p(r)  for  transmit  side 

transmit  window 

transmit  flags 

addr  of  first  packet  on  queue  to  frame  level 
addr  of  last  packet  on  queue  to  frame  level 
state  of  virtual  circuit 

state  of  output  side  of  logical  channel  (from  host) 

state  of  input  side  of  logical  channel  (to  host) 

virtual  circuit  number 

flags  for  virtual  circuit 

address  of  first  buffer  on  queue  to  host 

address  of  last  buffer  on  queue  to  host 

address  of  current  input  buffer  (to  host) 

address  of  current  output  buffer  (from  host) 


LOGICAL  CHANNEL  TABLE  RESPONSE; 


Offset  Contents 


u 

1 

2 


response  type  (202) 
logical  channel  number 
zero 

same  as  virtual  circuit  table  response 
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TABLE  5-3  (continued) 


ERROR  RESPONSE: 


Offset 

Contents 

0 

response 

typo  (206) 

1 

zero 

2 

zero 

3 

respo 

nse 

length 

4 

index 

of 

next  entry  in  e 

5 

index 

of 

last  used  entry 

b 

count 

of 

errors  encounte 

7- 

•n : 

error 

table:  4  bytes  per 

0 : 

error  number  -  s 

1: 

-Roserved- 

2-3: 

PC  at  error 

rror  table 
in  error  table 
red 

entry.  Each  entry  has  the  form 
ee  Table  5-4 


LAP  FRAME  RESPONSE: 

(NOTE:  These  offsets  are  guaranteed  to  change  from  one  release 
to  the  next) 


Offset  Contents 


0; 

1: 

2: 

3: 

4-5  ; 

t) : 


7-41 : 
42: 

43  : 

44  : 
45: 

4b  : 

47  ; 

50  : 

51  : 
52: 
53: 


Response  type  (212) 

Zero 

Zero 

Response  length 
-Reserved- 
Frame  Level  State 
0  -  initial  state 

1  -  UA/SARM  wait 

2  -  UA  wait 

3  -  Ready 
-Reserved- 


SARM 

sent  coun 

t 

SARM 

received 

count 

DISC 

sent  coun 

t 

DISC 

received 

count 

CMDR 

sent  coun 

t 

CMDR 

received 

count 

REJ  sent  count 
REJ  received  count 
RNR  sent  count 
RNR  received  count 
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TABLE  5-j  (continued) 


LAPB  FRAME  RESPONSE: 


Offset 
Q : 

1-2: 


3  : 

4  : 

1 J  : 


14 
lo 
1  7 
20 
21 
22 

23 

24 

25 
2o 
27 

30 

31 

32 


Contents 

response  type  (212) 
zero 

response  length 

Carrier  Detect  flag  (non-zero  if  carrier  detect  is  on) 
Frame  Level  State: 

0  -  initial  state 

1  -  UA/SABM  wait 

2  -  UA/DISC  wait 

3  -  Ready 

Tl  timer  value 
N2  counter  value 
SABM  sent  count 
SABM  received  count 
DISC  sent  count 
DISC  received  count 
CMDR  sent  count 
CMDR  received  count 
REJ  sent  count 
REJ  received  count 
RNR  sent  count 
RNR  received  count 

count  of  frames  received  with  bad  CRCs 
count  of  badly  formed  frames  received 
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TABLE  5-4 


ACC  IF-11Q/X.25  Error  Response  Error  Codes 
(all  values  are  octal) 


NOTE 

The  error  codes  are  the  lower  six  bits  of  each 
entry.  The  high  order  bits  are  used  internally 
and  should  be  masked  off  to  yield  the  error  codes 
listed  below. 


Code  Description 

4  -  Frame  level  attempted  to  retransmit  a  non-existent  frame 

5  -  CMDR  received  by  frame  level 

6  -  Frame  level  found  itself  in  an  undefined  state 

7  -  Attempt  to  send  call-accepted  packet  from  the  wrong  state 
lU  -  Attempt  to  send  call-request  packet  on  an  active  logical 

channel 

11  -  Attempt  to  send  clear-conf irm  packet  from  the  wrong  state 

12  -  Attempt  to  send  data  packet  on  virtual  circuit  zero 

13  -  Attempt  to  send  data  packet  from  wrong  state 

14  -  Attempt  to  send  interrupt  packet  from  wrong  state 

15  -  Attempt  to  send  interrupt-confirm  packet  from  wrong  state 

16  -  Attempt  to  send  reset-confirm  packet  from  wrong  state 

17  -  Attempt  to  send  RR  or  RNR  packet  from  wrong  state 

20  -  Packet  level  was  requested  to  transmit  a  poorly-formed  packet 

21  -  Packet  level  was  given  a  packet  for  an  invalid  logical  channel 

number 

22  -  A  packet  from  the  DCE  had  an  invalid  p(s) 

23  -  Invalid  packet  received  while  in  state  pi 

25  -  Invalid  packet  received  while  in  state  p2 

26  -  Invalid  packet  received  while  in  state  p3 

27  -  Invalid  packet  received  while  in  state  p5 

30  -  Invalid  packet  received  while  in  state  p6 

31  -  Invalid  packet  received  while  in  state  p7 

32  -  Invalid  packet  received  while  in  state  dl 

33  -  Invalid  packet  received  while  in  state  d2 

34  -  Invalid  packet  received  while  in  state  d3 

35  -  Illegible  packet  received  from  DCE 

36  -  A  virtual  circuit  was  found  to  be  in  an  undefined  state 
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TABLE  5-4  (continued) 


Code  Description 

41  -  A  packet  fro*Ti  the  DCE  contained  an  invalid  p(r) 

43  -  Free  list  exhausted 

44  -  The  buffer  monitor  was  unable  to  account  for  all  buffers 
4b  -  A  transfer  to  or  from  the  host  failed 

46  -  A  write  completed  on  a  logical  unit  assigned  for  reading 

47  -  The  output  side  of  a  logical  channex  v  ^s  in  an  undefined  state 

50  -  A  read  completed  on  a  logical  unit  assigned  for  writing 

51  -  The  input  side  of  a  logical  channel  was  in  an  undefined  state 

52  -  I/O  was  attempted  to  an  inactive  logical  unit 

53  -  Invalid  supervisory  command  received  while  in  data  xfer  state 

54  -  Invalid  supervisory  command  received  while  in  answer-wait 

state 

55  -  Invalid  supervisory  command  received  while  in  call-wait  state 

56  -  Invalid  supervisory  command  received  while  in  idle  state 

57  -  A  virtual  circuit  was  found  to  be  in  an  undefined  state 

60  -  Attempt  to  reassign  an  active  logical  unit  number 

61  -  NCP  received  an  undefined  command 

62  -  A  supervisory  command  specified  an  invalid  virtual  circuit 

number 
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TABLE  5-5 


HEADER 


BODY 


ACC  IF-11/X.25  Command  Formats 


CODE 

=  ANSWER 

CODE 

/ 

LCN 

LCN 

s 

VCN 

— 

COUNT 

COUNT 

r 

LENGTH 

>> 

<15 

CALLED 

)  (ASCII) 

J 

> 

J 

ADDRESS 

LENGTH 

'S 

^15 

CALLING 

ADDRESS 

J 

)  (ASCII) 

LENGTH 

■N 

<4 

CODE 

i 

— 

PROTOCOL 

VCN 

COUNT 

J 

LENGTH 

<63 

> 

- ^ 

) 

FACILITIES 

> 

LENGTH 

^12 

USER  DATA 

J 

=  CALL 


SAME  AS 
ANSWER 


=  RING 


SAME  AS 
ANSWER 
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TABLE  5-5  (continued) 


=  CLEAR  LOGICAL  CHANNEL 


SAME  AS  CALL/RING/ ANSWER 


=  CLEAR  VIRTUAL  CIRCUIT 


SAME  AS  ANSWER 
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TABLE  5-5  (continued) 


=  RESET,  INTERRUPT 


.  RESET  ACKNOWLEDGE , 
LOGICAL  CHANNEL  QUERY 


=  READY 


-  RESTART,  RESTART  ACKNOWLEDGE, 
~  FRAME  QUERY,  ERROR  QUERY 


^  RESTART 

”  (with  DIAGNOSTIC  PARAMETERS) 


NOTE  -  MUST  BE  3 
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TABLE  5-5  (continued) 


=  VIRTUAL  CIRCUIT  QUERY 


=  ERROR  RESPONSE, 

FRAME  RESPONSE, 

LOGICAL  CHANNEL  RESPONSE, 
VIRTUAL  CIRCUIT  RESPONSE 


5 


CHAPTER  6 


6.0  MICRODIAGNOSTICS 

6.1  Introduction  -  The  IF-llQ/X.25  raicrodiagnostics  perform 
subsystem  integrity  tests  upon  power-on  reset  and  display  the 
results  in  a  bank  of  eight  LEDs  which  are  clearly  visible 
without  removing  any  boards  or  cables.  This  display  provides 
quick  visual  verification  of  SYSTEM  operational  readiness. 
Detected  errors,  if  determined  by  the  operator  to  be 
inconsequential,  can  be  defeated  by  means  of  hardware  switches. 
If  any  errors  are  detected  (and  have  not  been  defeated  by  the 
operator)  then  processing  halts  with  the  error  status  displayed 
in  the  LEDs,  The  operator  must  cycle  power  down  and  back  up  to 
re-run  the  microdiagnostics  after  correcting  the  problem  or 
electing  to  ignore  the  error  by  means  of  the  defeat  switches. 
If  no  errors  are  detected  (or  all  which  are  detected  have  been 
defeated)  then  processing  continues  in  the  X.25  protocol  code. 
Note  that  the  X.25  protocol  code  idle  loop  "spins  the  lights" 
as  a  system  load  indication  where  a  heavy  traffic  load  will 
slow  the  "spin"  rate. 
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6.2  Display  LEDs  -  The  indicator  LEDs  are  located  on  the  XQ/CP 
P-board.  The  significance  of  each  LED  is  as  follows; 


+ - + - + - + - + - + - + - + - + 


13171615141312111 


+ 


+■ 


+• 


I  I  I  +->  ROM  Failure 

I  1  + - >  RAM  Failure 

I  + - >  siO  Failure 

+ - >  CTC  Failure 

- >  DMA  Register  Failure 

- >  DMA  Memory-to-Memory  Failure 

- >  Unexpected  Interrupt  during 

initialization 

- >  all  tests  complete 


Upon  power-on  reset,  all  of  the  display  LEDs  are  turned  off  and 
testing  begins.  All  tests  are  run  to  completion  and  then  the 
various  error  statuses  are  displayed  along  with  the  ALL  TESTS 
COMPLETE  indication. 


6.3  Error  Defeat  Switches  -  Hardware  initialization  errors  can 
be  ignored  by  means  of  a  bank  of  DIP  switches  also  located  on 
the  XQ/CP  P-Board.  In  order  to  defeat  each  detected  error  (as 
represented  by  a  lit  LED) ,  it  is  necessary  to  turn  on  (or 
close)  the  corresponding  switch.  Each  and  every  error  must  be 
defeated  for  processing  to  continue  into  the  X.25  protocol 
code.  On  the  other  hand,  processing  will  not  continue  if  a 
switch  is  set  for  which  there  is  no  corresponding  error.  In 
addition,  the  high  order  switch,  which  corresponds  with  the  ALL 
TESTS  DONE  condition  and  is  not  an  error,  should  be  left  off 
(or  open)  even  though  the  LED  is  lit. 
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APPENDIX  B  -  SAMPLE  DEVICE  DRIVER  LISTING 
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